Csit.Delta.Client3.D8RegularInstance

Базы данных для стандартного инстанса¶

Базы данных рассчитаны на работу в СУБД MS SQL Server 2008 (или новее), PostgreSQL 9.6 (или новее).

БД НСИ стандартного инстанса¶

Таблицы для стандартных узлов НСИ¶

PARAMS ¶

Список параметров стандартного инстанса Дельта.

Название	IS NULL	Тип	Описание
ID		int	Номер параметра
PARAMTYPE		int	Тип параметра (0 - аналоговый, 1 - дискретный, 2 - векторный, 3 - табличный)
GROUPID		int	Идентификатор группы параметра
SCALEID		int	Идентификатор шкалы параметра
DEVICEID		int	Идентификатор устройства параметра
DEVICECHAN		nvarchar[50]	Канал устройства
DS_ID		int	Номер источника данных
DS_CHAN		nvarchar[50]	Канал источника данных
NAME		nvarchar[254]	Название параметра
ADDITIONALNAME	да	nvarchar[254]	Дополнительное имя параметра
SHORTNAME	да	nvarchar[20]	Короткое имя параметра
AKS	да	nvarchar[20]	Код AKS
FLAGS		int	Флаги параметра
SCRIPT_ENGINE_ID		int	Идентификатор интерпретатора скрипта
SCRIPT_TEXT	да	text	Скрипт для вычисления параметра
SCANRATE		tinyint	Период обработки параметра
INTERVAL		smallint	Интервал параметра
ALARMDELAY		smallint	Задержка срабатывания сигнализации
STALETIMEOUT		smallint	Время устаревания параметра
CALCTIME		int	Расписание запуска скрипта
SAVETIME		int	Расписание для сохранения параметра в архив по времени
STEP		smallint	Шаг параметра (с какой периодичностью идут значения)
METATYPE	да	uniqueidentifier	Идентификатор метатипа для табличного параметра
PLANNODE	да	nvarchar[254]	Идентификатор узла шаблона для параметра
OWNERNODE	да	nvarchar[254]	Идентификатор узла владельца параметра

APARAMS ¶

Таблица для хранения дополнительной информации об аналоговых параметрах (уставки, апертуры и т.п).

Название	IS NULL	Тип	Описание
ID		int	Номер параметра (ссылка на таблицу PARAMS)
COEFFA	да	float	Не используется
COEFFB	да	float	Не используется
LIMITLO		float	Нижний предел достоверности
LIMITHI		float	Верхний предел достоверности
DELTASAVE		float	Апертура на сохранение
DELTASEND		float	Апертура на пересылку (не используется)
ALARMUP1		float	Первая уставка вверх
ALARMUP2		float	Вторая уставка вверх
ALARMDOWN1		float	Первая уставка вниз
ALARMDOWN2		float	Вторая уставка вниз
AFLAGS		int	Флаги (не используется)
SUBTYPE		int	Подтип параметра

DPARAMS ¶

Таблица для хранения дополнительной информации о дискретных параметрах.

Название	IS NULL	Тип	Описание
ID		int	Номер параметра (ссылка на таблицу PARAMS)
DFLAGS		int	Флаги (не используется)
SUBTYPE		int	Подтип параметра

VPARAMS ¶

Дополнительная информация о векторных параметрах.

Название	IS NULL	Тип	Описание
ID		int	Номер параметра (ссылка на таблицу PARAMS)
SUBTYPE		int	Подтип параметра
COEFFA	да	float	Не используется
COEFFB	да	float	Не используется
MAXSIZE		int	Максимальный размер значений в байтах
VFLAGS		int	Флаги (не используется)

DEVICES ¶

Список устройств.

Название	IS NULL	Тип	Описание
ID		int	Идентификатор устройства
NAME		nvarchar[254]	Название устройства

SCALES ¶

Список шкал для параметров.

Название	IS NULL	Тип	Описание
ID		int	Идентификатор шкалы
TYPE		int	Тип шкалы (0 - аналоговая, 1 - дискретная, 2 - векторная)
UNIT		nvarchar[50]	Единицы измерения
MINVALUE		float	Минимальное значения
MAXVALUE		float	Максимальное значения
PRECISION		int	Точность, кол-во знаков после запятой которые нужно отображать
NAME	да	nvarchar[50]	Название шкалы
FORMAT	да	nvarchar[254]	Форматная строка для вывода значения
AGCOEFF	да	float	Коэффициент для приведения к часовому интегрированному значению
AGUNITS	да	nvarchar[50]	Единицы измерения для интегрированного значения

DSCALES ¶

Таблица для хранения значений и описаний для дискретных шкал.

Название	IS NULL	Тип	Описание
SCALEID		int	Идентификатор устройства
VALUE		int	Значения параметра
TEXT		nvarchar[254]	Описание значения параметра

GROUPS ¶

Список групп.

Название	IS NULL	Тип	Описание
ID		int	Идентификатор группы
NAME		nvarchar[254]	Название группы

SCRIPT_ENGINES ¶

Список доступных интерпретаторов скриптов.

Название	IS NULL	Тип	Описание
ID		int	Идентификатор интерпретатора скрипта
NAME		nvarchar[50]	Название
PROGID		nvarchar[254]	ProgID для интерпретатора скрипта
SOURCE_CODE	да	text	Код для объявления переменных и вспомогательных функция

LOCALIZATION ¶

Таблица для хранения перевода строковых констант на другие языки.

Название	IS NULL	Тип	Описание
LCID		int	Идентификатор локалии
ORIGINALSTR		nvarchar[254]	Исходный текст
LOCALSTR		nvarchar[254]	Локализованный текст

PROPERTIES ¶

Свойств базы данных (дата создания, дата редактирование, версия и т.п.).

Название	IS NULL	Тип	Описание
PROPNAME		nvarchar[32]	Название свойства
PROPVAL	да	nvarchar[max]	Значение свойства
PROPCOMMENTS	да	nvarchar[max]	Комментарий

Свойства:

• CreationDate
  Время создания БД НСИ.
   
• FormatVersion
  Версия формата БД НСИ.
   
• ModificationDate
  Время последнего изменения БД.
   
• StructModificationDate
  Время последнего изменения структуры БД НСИ.
   
• ParamSecurityInstance
  Имя инстанса, через который будет контролироваться доступ к параметрам в НСИ этого инстанса.

Таблицы для контроля доступа и проверки обновлений¶

ACCESS_BLOCK ¶

Таблица для проверки доступа на блокирование параметров.

Название	IS NULL	Тип	Описание
ACCESS_CODE		varchar[50]	Идентификатор для доступа

ACCESS_EVENT ¶

Таблица для проверки доступа на квитирование параметров.

Название	IS NULL	Тип	Описание
ACCESS_CODE		varchar[50]	Идентификатор для доступа

ACCESS_READ ¶

Таблица для проверки доступа на чтение данных параметров.

Название	IS NULL	Тип	Описание
ACCESS_CODE		varchar[50]	Идентификатор для доступа

ACCESS_WRITE¶

Таблица для проверки доступа на запись данных параметров.

Название	IS NULL	Тип	Описание
ACCESS_CODE		varchar[50]	Идентификатор для доступа

TRIGGERS¶

Таблица для отслеживания изменений в НСИ.

Название	IS NULL	Тип	Описание
ID		int	Номер триггера (0 - полная перезагрузка инстанcа, 1 - частичная перезагрузка)
triggerTIME		timestamp	Метка времени значения триггера
triggerVALUE		int	Значение триггера

Некоторые сервисы отслеживаются значения из TRIGGERS. В случае обнаружения изменения triggerVALUE выполняется перезагрузка инстанcа.

Таблицы для нестандартных узлов НСИ¶

META_ACCESS¶

Таблица для хранения доступных объектов для конкретного пользователя или группы (роли).

Название	IS NULL	Тип	Описание
ObjectId		uniqueidentifier
Pid		int
Access		int

META_CATEGORIES¶

Список категорий для групп пользователей и ролей.

Название	IS NULL	Тип	Описание
CategoryName		nvarchar[32]
Flag		bigint
DbRole	да	nvarchar[128]
SrvRole	да	nvarchar[128]
Position	да	int

META_CATEGORYBITS¶

Битовые маски для категорий пользователей.

Название	IS NULL	Тип	Описание
CategoryName		nvarchar[32]
Flag		bigint
Position		int
Pid	да	int

META_ENUMS¶

Список значений для перечислений.

Название	IS NULL	Тип	Описание
NodeTypeId		uniqueidentifier	Идентификатор метатипа
Value		int	Числовое значения
ShortName	да	nvarchar[64]	Короткое описание (название)
CompatibleMask	да	int	Маска для комбинирования с другими значениями
DisplayName	да	nvarchar[1024]	Описание
NodeFlags	да	int	Флаги
ParentValue	да	int	Родительское значения

META_MEMBERSHIP¶

Признак принадлежности элементов к определенных группам.

Название	IS NULL	Тип	Описание
MemberPid		int
GroupPid		int

META_NODEINFO¶

Описание узлов, их название, флаги и связь с родителем за конкретное время.

Название	IS NULL	Тип	Описание
NodeId		uniqueidentifier	Идентификатор узла
ParentNodeId	да	uniqueidentifier	Идентификатор родительского узла
ValidFrom		datetime2	Время начала действия записи
ValidTo	да	datetime2	Время конца действия записи
DisplayName	да	nvarchar[256]	Описание
NodeFlags	да	int	Флаги
Position	да	int	Позиция
WriteTime		datetime2	Время изменения записи (используется для синхронизации)
Deleted		bit	Признак удаления

META_NODES¶

Список элементов в метатипа.

Название	IS NULL	Тип	Описание
NodeId		uniqueidentifier	Идентификатор узла
NodeTypeId		uniqueidentifier	Идентификатор метатип
ShortName		nvarchar[64]	Короткое название - имя узла
NodeRole	да	int	Роль
WriteTime		datetime2	Время изменения записи (используется для синхронизации)
Deleted		bit	Признак удаления

META_PARAMS¶

Список параметров из системы Дельта для элементов метатипа.

Название	IS NULL	Тип	Описание
NodeId		uniqueidentifier	Идентификатор узла
ParamSid		nvarchar[256]	SID параметра
ValidFrom		datetime2	Время начала действия записи
ValidTo	да	datetime2	Время конца действия записи
ShortName	да	nvarchar[64]	Короткое название параметра
DisplayName	да	nvarchar[256]	Описание параметра
ParamFlags	да	int	Флаги
ParamRole	да	int	Роль
Position	да	int	Позиция в списке

META_PRINCIPALS¶

Список пользователей и ролей.

Название	IS NULL	Тип	Описание
PrincipalName		nvarchar[128]
Pid		int
PrincipalType		int
Properties	да	nvarchar [max]
Category	да	nvarchar[1024]
LoginName	да	nvarchar[128]
LoginType	да	nvarchar[60]
Password	да	varbinary[256]

META_PROPERTIES¶

Список свойств (столбцов) в метатипов.

Название	IS NULL	Тип	Описание
NodeTypeId		uniqueidentifier	Идентификатор типа
PropertyId		int	Номер свойства
DataType		int	Тип значения
ShortName		nvarchar[64]	Имя свойства
PropertyRole	да	int	Роль
DataTypeEx	да	nvarchar[512]	Расширенное описание типа
DataSize	да	int	Размер значения

META_PROPERTYINFO¶

Описание свойств (столбцов) для метатипов.

Название	IS NULL	Тип	Описание
NodeTypeId		uniqueidentifier	Идентификатор типа
PropertyId		int	Номер свойства
ValidFrom		datetime2	Время начала действия записи
ValidTo	да	datetime2	Время конца действия записи
DisplayName	да	nvarchar[256]	Описание свойства
PropertyFlags	да	int	Флаг свойства
Position	да	int	Позиция в списке

META_TYPEDESC¶

Дополнительное описание для метатипа.

Название	IS NULL	Тип	Описание
NodeTypeId		uniqueidentifier	Идентификатор типа
NodeRolesEnum	да	uniqueidentifier	Тип с описание роли
NodeFlagsEnum	да	uniqueidentifier	Тип с описание флагов
PropertyRolesEnum	да	uniqueidentifier	Тип с описание ролей свойства типа
PropertyFlagsEnum	да	uniqueidentifier	Тип с описание флагов свойств типа
ParamRolesEnum	да	uniqueidentifier	Тип с описание ролей параметров
ParamFlagsEnum	да	uniqueidentifier	Тип с описание флагов параметров
CompatibleParent	да	nvarchar[max]	Родительский тип описания
DocBrief	да	nvarchar[max]	Описания типа
DocFull	да	nvarchar[max]	Описание типа

META_TYPES¶

Список метатипов.

Название	IS NULL	Тип	Описание
NodeTypeId		uniqueidentifier	Идентификатор типа
ParentNodeTypeId	да	uniqueidentifier	Идентификатор родительского типа
ShortName		nvarchar[64]	Название типа
DisplayName	да	nvarchar[256]	Описание типа
NodeTypeFlags	да	int	Флаги
WriteTime		datetime2	Время изменения записи (используется для синхронизации)
Deleted		bit	Признак удаления
ArgType		uniqueidentifier	Тип аргумента

META_VALUES¶

Список значений свойств узлов метатипа с привязкой ко времени.

Название	IS NULL	Тип	Описание
NodeTypeId		uniqueidentifier	Идентификатор типа
NodeId		uniqueidentifier	Идентификатор узла
PropertyId		int	Номер свойства
ValueNumber	да	float	Числовое значение
ValueText	да	nvarchar[max]	Строковое значения
ValueBinary	да	varbinary[max]	Значения в виде массива байт
ValueId	да	uniqueidentifier	Знание в виде GUID
State	да	int	Статус
Timestamp		datetime2	Время значения
WriteTime		datetime2	Время изменения записи (используется для синхронизации)
Deleted		bit	Признак удаления

Роли БД НСИ¶

delta_datablock	Роль с правами блокировать значения параметры
delta_dataevent	Роль с правами квитировать значение параметров
delta_datareader	Роль с правами на чтения значений параметров
delta_datawriter	Роль с правами на запись значений параметров
delta_meta_dataadmin	Роль с полными правами на метатипы
delta_meta_dataeditor_direct	Роль с правами на редактирование узлов и свойств метатипов
delta_meta_dataeditor_rls	Роль с правами на чтение и редактирование узлов через RLS-представления (с проверкой прав доступа на типы и узлы)
delta_meta_datareader_direct	Роль с правами на чтение узлов и их свойств метатипа
delta_meta_datareader_rls	Роль с правами на чтение узлов и их свойств метатипа через-RLS представления
delta_meta_rlseditor	Роль с правами на редактирование доступных пользователем узлов и типов
delta_meta_rlsreader	Роль с правами на чтения доступных пользователем узлов и типов
delta_paramdb_dataadmin	Роль с правами на редактирование НСИ
delta_paramdb_reader	Роль с правами на чтение данных из НСИ

Представления БД НСИ¶

META_NODESWITHINFO	Список узлов и их описание объеденных
META_RLS_ACCESS	Список доступных текущему пользователю узлом
META_RLS_NODEINFO	Отфильтрованный список описания узлов
META_RLS_NODES	Отфильтрованный список узлов метатипа
META_RLS_NODESWITHINFO	Отфильтрованный список узлов и их описание
META_RLS_PARAMS	Отфильтрованный список параметров из система Дельта для привязанных к узлам метатипа
META_RLS_VALUES	Отфильтрованный список значений свойств узлов метатипа

Хранимые процедуры и функции БД НСИ¶

META_CREATE_T_TABLE	Создать таблицу для хранения узлов табличного типа
META_RLS_GETPIDS
META_RLS_GETPRINCIPAL
META_CREATE_TABLE_SCRIPT	Создать скрипт для табличного типа
META_DEFINE_R_TABLE	Создать скрипт для табличного типа параметров

Архивная БД стандартного инстанса¶

Таблицы архивной БД¶

Addmmyyyy¶

Таблица значений аналоговых параметров за определенные сутки по UTC. Дата суток закодирована в имени таблицы: dd - число, mm - месяц, yyyy - год.

Название	IS NULL	Тип	Описание
N		int	Номер параметра (LocalId)
T		int	Миллисекунда значения от начала суток
V		float	Значение
S		int	Статус значения
XS		int	Расширенный статус значения

Dddmmyyyy¶

Таблица значений дискретных параметров за определенные сутки по UTC. Дата суток закодирована в имени таблицы: dd - число, mm - месяц, yyyy - год.

Название	IS NULL	Тип	Описание
N		int	Номер параметра (LocalId)
T		int	Миллисекунда значения от начала суток
V		int	Значение
S		int	Статус значения
XS		int	Расширенный статус значения

Vddmmyyyy¶

Таблица значений векторных параметров за определенные сутки по UTC. Дата суток закодирована в имени таблицы: dd - число, mm - месяц, yyyy - год.

Название	IS NULL	Тип	Описание
N		int	Номер параметра (LocalId)
T		int	Миллисекунда значения от начала суток
V		varbinary(max)	Значение
S		int	Статус значения
XS		int	Расширенный статус значения

R_TypeShortName¶

Значения табличных параметров определенного метатипа. Метатип указывается в имени таблицы (TypeShortName).
Формат таблицы определяется метатипом TypeShortName, однако первые три столбца имеют фиксированное имя и тип:

Название	IS NULL	Тип	Описание
ParamLocalId	да/нет	int	Номер параметра (LocalId)
Timestamp	да/нет	datetime2(3)	Метка времени значения
State	да/нет	int	Статус значения

mmtbase¶

Содержит последние текущие значения инстанса, сохраненные в архив.

Название	IS NULL	Тип	Описание
N		int	Номер параметра (LocalId)
D		smalldatetime	Дата метки времени значения (в UTC)
T		int	Миллисекунды метки времени значения от начала суток D
V		float	Значение для аналогового или дискретного параметра
S		int	Статус значения
XS		int	Расширенный статус значения
V2	да	varbinary(max)	Значение для векторного параметра

R_EventAckLog¶

Содержит журнал квитирования тревог параметров.

Название	IS NULL	Тип	Описание
ParamLocalId	да	int	Не используется.
Timestamp	нет	datetime2(3)	Метка времени события квитирования.
State	нет	int	Статус записи квитирования.
AckedLocalId	нет	int	Номер параметра (LocalId), для которого была квитирована тревога.
AckedValue	да	float	Значение параметра в момент квитирования для аналоговых или дискретных параметров. Для векторных - NULL.
AckedState	нет	int	Статус параметра в момент квитирования.
AckedTimestamp	нет	datetime2(3)	Метка времени параметра в момент квитирования или NULL, если она не известна.
LoginName	да	nvarchar(128)	Логин клиента, использовавшийся для квитирования.
Address	да	nvarchar(128)	Адрес клиента, выполнившего квитирование.

PROPERTIES¶

Свойства базы данных.

Название	IS NULL	Тип	Описание
PROPNAME		nvarchar[32]	Название свойства
PROPVAL	да	nvarchar[max]	Значение свойства
PROPCOMMENTS	да	nvarchar[max]	Комментарий

Свойства:

• ArchCreationDate
  Время создания архивной БД.
   
• ArchFormatVersion
  Версия формата архивной БД.
   
• ArchStructModificationDate
  Время последнего изменения структуры архивной БД.

Хранимые процедуры архивной БД¶

d8_arch_createtable	ХП для создание таблицы для создания архивной таблицы
d8_readmb	ХП для чтения данных из таблицы mmtbase
d8_writemb	ХП для записи в таблицу mmtbase

Роли архивной БД¶

delta_arch_create	Роль с правами на создание таблиц (запуска ХП d8_arch_createtable)
delta_arch_modify	Роль с правами редактировать архивные таблицы
delta_datareader	Роль с правами на чтение архивных таблицы
delta_datawriter	Роль с правами запись данных в архивные таблицы

История версий формата БД¶

• 2.12.18.0314
  • Добавлены поля PLANNODE и OWNERNODE в таблицу PARAMS

• 2.11.17.0831
  • Добавлена таблица R_EventAckLog в архивную базу данных

• 2.10.16.1003
  • Добавлены новые столбцы WriteTime и Deleted в таблицы:
    • META_TYPES
    • META_NODES
    • META_NODEINFO
    • META_VALUES
    • META_PARAMS
  • Переделаны триггеры для изменения RLS-вьюшек.
  • Добавлены права на новые поля для роли delta_meta_dataeditor_direct.

• 2.9.16.0622
  • Добавлены новые таблицы:
    • META_TYPEDESC
    • META_CATEGORYBITS
    • META_ENUMS (24/08/2016)
  • Переделаны функции:
    • META_RLS_GETPIDS
    • META_RLS_GETPRINCIPAL
  • Увеличена длина столбца META_PRINCIPALS.Category до nvarchar(1024).
  • Тип столбца META_CATEGORIES.Flag - стал bigint.
  • Добавлены хранимые процедуры и функции:
    • META_CREATE_T_TABLE
    • META_CREATE_TABLE_SCRIPT
    • META_DEFINE_R_TABLE
  • META_CREATE_E_TABLE больше не используется, из таблицы META_ENUMS (24/08/2016)
  • Добавлен столбец META_PROPERTIES.DataSize.
  • Мета таблицы поддерживаются только с MS SQL 2008 (2000 и 2005 не поддерживаются).

• 2.8.16.0414
  • Добавлены новые поля:
    • PARAMS.STEP
    • APARAMS.SUBTYPE
    • DPARAMS.SUBTYPE
    • SCALES.AGCOEFF (float)
    • SCALES.AGUNITS (тип как у UNITS)
  • Добавлена роль delta_paramDb_reader.

• 2.7.16.0323
  • Размер поля FORMAT в таблице SCALES увеличен до 254 символов.
  • Добавлены триггеры отслеживающие изменения в таблице LOCALIZATION.

• 2.6.15.1124
  • Добавлены таблицы ACCESS_BLOCK и ACCESS_EVENT.
  • Добавлены новые роли delta_dataevent и delta_datablock.
  • Теперь мета таблицы это часть НСИ.

• 2.5.15.618
  • Добавлена таблицы LOCALIZATION.

• 2.4.14.1117
  • Добавлена поддержка SQL 2000.
  • Изменения в таблице mtbase, добавлена поддержка векторных параметров.

• 2.3.14.417
  • Таблицы BIND_xxx больше не используются.
  • Добавлены новые поля в таблицу PARAMS:
    • SCANRATE
    • INTERVAL
    • STALETIMEOUT
    • CALCTIME
    • SAVETIME
  • Добавлены новые поля в таблицу SCALES
    • NAME
    • FORMAT

• 2.2.11.726
  • Теперь используется таблица VPARAMS.

• 2.1.9.417
  • Поле PRECISION в таблице SCALES теперь NOT NULL и значение по умолчанию -1.
  • Добавлена таблица PROPERTIES, теперь номер версии храниться в базе данных.
  • Добавлена триггеры на основные таблицы для отслеживания изменений с сохранением даты редактирования в таблицу PROPERTIES.
  • Добавлены таблицы BIND_MODULES, BIND_GROUPS, BIND_PARAMS.

• 2.0.8.3
  • В архивную базу добавлена таблица mmtbase.

• 2.0.8.2
  • В таблице SCALES добавлено поле PRECISION (IS NULL).

• 2.0.8.1
  • Таблицы больше не используются:
    • USERLOCATIONS
    • USERS
    • VERIFICATIONS

• 2.0.8.0
  • Первая версия базы данных (для Дельта V2), содержит таблицы:
    • USERLOCATIONS
    • USERS
    • VERIFICATIONS